\pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The
\b lookupd
\b0 daemon is used in conjunction with NetInfo to speed up various system lookups, such as host entries, user names, and printer names. For performance reasons lookupd caches information about the location of NetInfo domains. It also caches various other information, including groups, user accounts, and mount entries. There are two different types of caches: the user entry cache (also called the pwent cache), and the other caches (hostname, mounts, logged-in user, root user, and printers). By default, the user entry cache is preloaded once, and lookupd then waits until the getpwent library routine is used before checking whether the cache contents have expired. (This is called lazy cache refresh.)\
Other caches are maintained in a consistent fashion: prior to using the cached information, lookupd checks whether the source NetInfo database has changed. If not, the cached information is used; if so, that cache is refreshed and the new information used.\
The logged-in user and the root user caches are flushed every 20 minutes, as well as when passwords are changed and when a user logs in or out.\
The lookupd daemon supports the Network Information Service (NIS, formerly called Yellow Pages or YP) and BIND. By default, these features are turned off. NIS can be enabled using the HostManager application, by setting the NIS Domain Name. BIND is enabled by the existence of an /etc/resolv.conf file. The search policy when these are enabled is to try NetInfo first. If the information is located there, the result is returned. Otherwise, BIND is tried next (for host names and addresses), then NIS.\
The lookupd daemon will restart itself in response to a SIGHUP signal, which can be sent from the shell via ``kill -HUP'' to lookupd's process id (pid). This is useful to tell lookupd that things have changed. For example, if the network gets turned on later, sending a SIGHUP to lookupd will get lookupd to recognize the network and look for information on it.
CommandOption
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Force regularly scheduled updates of the pwent cache (by turning off lazy cache refresh); default is every 30 minutes
2{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Set the lazy refresh interval for the pwent cache to the specified number of minutes. A value of zero turns off pwent caching altogether
CommandArgument
minutes
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The number of minutes for the lazy refresh interval
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Force an immediate pwent cache reload only if it is out of date, then exit. Incompatible with all other options
${\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Asks that all lookup requests be logged to the specified file. Information logged includes the routine called, argument to the routine (an asterisk here denotes a cache hit), total number of calls to the routine, CPU time this call took (in microseconds), and total CPU time used by this routine (also in microseconds). Note that the lookupd log can become quite large over time
filename
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The file to log all lookup requests to
\b0 is the daemon responsible for finding, creating and destroying NetInfo (netinfod(8)) servers. When it starts up, it reads the directory /etc/netinfo for directories with the extension ".nidb" and starts up a netinfod(8) server for each NetInfo directory it finds. nibindd will automatically destroy the registration for a netinfod server if it disappears for any reason. It will take the netinfod servers down if it is shut down gracefully.
\b0 lets you find out information about the domains served on a given machine. It also allows you to create and destroy NetInfo databases. It is simply an interface to nibindd(8), to which it sends all of its requests. nidomain will allow one to create multiple levels of NetInfo hierarchy, but it is not a particularly easy way to do it. One should use the NetManager application for setting up two-level hierarchies by clicking the "Configuraton Server" checkbox.
\pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 List the domains by tag served on the given hostname. If hostname is unspecified, the local host is used
hostname
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\f0\b0\i0\ulnone\ql\fs24\fi0\li0\gray0\fc0\cf0\up0\dn0 The hostname to list the domains for
\pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 Create a new NetInfo database and server on the local machine for the domain tag of tag
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 The tag of the domain to create a new database for
\pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 Destroy the local NetInfo database and server associate with the domain tagged tag. If the database was associated with a clone, the machine's "serves" property on the master is NOT modified to reflect the fact that the database has been deleted
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The tag of the domain to destroy the database for
\pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 Creates a clone NetInfo database with the domain tagged tag. The database is cloned from the machine master and remote tag remotetag. The machine's "serves" property should be set up prior to running this command to contain the entry "./tag"
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The tag of the domain to clone a database for
master/remotetag
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx520\tx1060\tx1600\tx2120\tx2660\tx3200\tx3720\tx4260\tx4800\tx5320\f0\b0\i0\ulnone\fs24\fc0\cf0 The master machine and remote tag to clone the database from
\b0 reads the given NetInfo domain and dumps a UNIX format file to standard output
j{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Interpret the domain as a tagged domain. For example, "trotter/network" refers to the database tagged "network" on the machine "trotter". You may supply an IP address instead of a machine name
format
aliases
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Dumps an aliases(5) format file
bootparams
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Dumps a bootparams(5) format file
bootptab
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Dumps a bootptab(5) format file
exports
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Dumps an exports(5) format file
fstab
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Dumps a fstab(5) format file
group
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Dumps a group(5) format file
hosts
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Dumps a hosts(5) format file
networks
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Dumps a networks(5) format file
passwd
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Dumps a passwd(5) format file
printcap
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Dumps a printcap(5) format file
protocols
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Dumps a protocols(5) format file
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Dumps a rpc(5) format file
services
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Dumps a services(5) format file
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx533\tx1067\tx1601\tx2135\tx2668\tx3202\tx3736\tx4270\tx4803\tx5337\f0\b0\i0\ulnone\fs24\fc0\cf0 The file format to dump the database info in
domain
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\f0\b0\i0\ulnone\ql\fs24\fi0\li0\gray0\fc0\cf0\up0\dn0 The domain to dump the database for
\b0 reads standard input, interprets it given the UNIX file format and loads the parsed information into the given NetInfo domain. niload effectively overwrites the existing directory. It won't delete (by default) entries that are in the directory, but that don't exist in the input. The -d option will allow one to delete entries. niload must be run as superuser on the master netinfo server for the given domain, unless one provides the -p option which will allow one to run from anywhere in the network.
@Prints a "+" for each entry loaded, a "-" for each entry deleted
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Delete entries which are in the directory, but not in the input
%{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Prompt for the root password of the given domain so that one can run from other locations in the network besides the master
\b0 lets you to do arbitrary reads and writes on the given NetInfo domain. In order to perform writes, niutil must be run as root on the NetInfo master for the database, unless the -p option is given. The directory specified by path is separated by "/"s, similar to UNIX. The property names may be given in the path using a "=", but will default to the property name "name".
j{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Interpret the domain as a tagged domain. For example, "eastman/network" refers to the database tagged "network" on the machine "eastman". You may supply an IP address instead of a machine name
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Prompt for the root password of the given domain so that one can run from other locations in the network besides the master
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Create a new property in the directory path. propkey refers to the name of the property; 0 or more property values may be specified. If the named property already exists, it's overwritten
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\f0\b0\i0\ulnone\ql\fs24\fi0\li0\gray0\fc0\cf0\up0\dn0 The domain to create the new property in
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\f0\b0\i0\ulnone\ql\fs24\fi0\li0\gray0\fc0\cf0\up0\dn0 The directory path to create the new property in
propkey
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The name of the property
propval
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The property value(s)
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Destroy the property with name propkey in the given path
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The domain to destroy the property in
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The path to destroy to property in
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The name of the property to be destroyed
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 Read the properties associated with the directory specified in the given path
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The path to read properties for
\pard\tx1152\tx2304\tx3456\tx4608\tx5760\tx6912\tx8064\tx9216\tx10368\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 List the directories in the given domain/path. The directory ID's are listed along with any names they may have
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The domain to list directories for
{\rtf0\ansi{\fonttbl\f0\fmodern Courier;}
\margl40
\margr40
\pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f0\b0\i0\ulnone\fs24\fc0\cf0 The path to list the directories for